home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / zwrite.man < prev   
Encoding:
Text File  |  1992-11-22  |  8.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ZWRITE                    User Commands                    ZWRITE
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      zwrite - write to another user via Zephyr
  10.  
  11. SSYYNNOOPPSSIISS
  12.      zzwwrriittee [ --aa ] [ --dd ] [ --vv ] [ --qq ] [ --tt ] [ --uu ] [ --oo ] [ --nn
  13.      ] [ --ll ] [ --OO opcode ] [ --ss signature ] [ --cc class ] [ --ii
  14.      instance ] [ --ff arg ] [ uusseerr ...  ] [ --mm mmeessssaaggee ]
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      _Z_w_r_i_t_e sends a message from you to another user through the
  18.      _z_e_p_h_y_r(_1) notification service.  The user must have sub-
  19.      scribed to messages of the appropriate class and instance
  20.      using the _z_c_t_l(_1) program.
  21.  
  22.      _Z_w_r_i_t_e understands the following options.
  23.  
  24.      --aa          Causes _z_w_r_i_t_e to send the message authenticated,
  25.                  using _K_e_r_b_e_r_o_s to perform the authentication.
  26.                  This is the default.
  27.  
  28.      --dd          Causes _z_w_r_i_t_e to send the message unauthenti-
  29.                  cated.
  30.  
  31.      --vv          Causes _z_w_r_i_t_e to print what type of message it
  32.                  is sending, and whether or not it was success-
  33.                  ful.
  34.  
  35.      --qq          Forces _z_w_r_i_t_e to suppress information about
  36.                  whether or not the message was sent.
  37.  
  38.      --tt          Prevents _z_w_r_i_t_e from expanding tabs in the mes-
  39.                  sage into appropriate spaces.  Normally _z_w_r_i_t_e
  40.                  will expand any tabs it finds into the appropri-
  41.                  ate number of spaces to maintain separation
  42.                  based on 8-character tab stops.
  43.  
  44.      --ll          Causes _z_w_r_i_t_e to ignore `.' on a line by itself
  45.                  in the input and only end a typed message when
  46.                  the user types the end-of-file character (usu-
  47.                  ally control-D).  When the input is not a termi-
  48.                  nal, this is the default action.
  49.  
  50.      --uu          Sends an urgent message.  This changes the
  51.                  _z_e_p_h_y_r instance of the message to ``URGENT''.
  52.  
  53.      --oo          Causes _z_w_r_i_t_e to ignore the Zephyr variables
  54.                  _z_w_r_i_t_e-_c_l_a_s_s, _z_w_r_i_t_e-_i_n_s_t, and _z_w_r_i_t_e-_o_p_c_o_d_e
  55.                  when picking a default class, instance, and
  56.                  opcode.
  57.  
  58.      --nn          prevents _z_w_r_i_t_e from sending a PING message to
  59.                  verify the recipient is subscribing to messages.
  60.  
  61.  
  62.  
  63. MIT Project Athena      October 26, 1989                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZWRITE                    User Commands                    ZWRITE
  71.  
  72.  
  73.  
  74.                  By default, _z_w_r_i_t_e will send a notice to the
  75.                  destination class, instance, and recipient, with
  76.                  opcode ``PING'' before sending the message.  If
  77.                  the PING is sent, and the server response indi-
  78.                  cates there are no recipients subscribed to your
  79.                  message, _z_w_r_i_t_e exits without sending a message.
  80.                  When the --mm option is used, no PING is sent.
  81.  
  82.      --ss _s_i_g_n_a_t_u_r_e
  83.                  sets the signature to be included in the mes-
  84.                  sage.  This overrides both the user's name (as
  85.                  found in the password file) and any setting of
  86.                  the Zephyr variable _z_w_r_i_t_e-_s_i_g_n_a_t_u_r_e.  _s_i_g_n_a_t_u_r_e
  87.                  must be a single argument, hence when using a
  88.                  shell it should be quoted with double quotes.  A
  89.                  _s_i_g_n_a_t_u_r_e argument of "" leaves the signature in
  90.                  the message empty.
  91.  
  92.      --cc _c_l_a_s_s    Allows a user to specify a different class for
  93.                  the message.  This allows a message to be sent
  94.                  to a large group of people with some degree of
  95.                  security.  See _z_e_p_h_y_r(_1) and _z_e_p_h_y_r_d(_8) for a
  96.                  description of how to restrict access to
  97.                  classes.  When this option is specified, the
  98.                  message is sent to recipient "*" unless an addi-
  99.                  tional list of recipients is specified.
  100.                  This argument may not be used in conjunction
  101.                  with the -f option.
  102.  
  103.      --ii _i_n_s_t_a_n_c_e Allows a user to specify a different instance
  104.                  than the default.  When this option is used, the
  105.                  message is sent to recipient "*" unless an addi-
  106.                  tional list of recipients is specified.  This
  107.                  allows a message to be sent to a large group of
  108.                  people (e.g. a development group) just by having
  109.                  the members subscribe to messages of class "MES-
  110.                  SAGE", the specified instance, and recipient
  111.                  "*".
  112.                  This argument may not be used in conjunction
  113.                  with the -f option.
  114.  
  115.      --OO _o_p_c_o_d_e   Allows a user to specify a different opcode for
  116.                  the message.  Some Zephyr notice display pro-
  117.                  grams may use the opcode to decide how to
  118.                  display a notice.
  119.  
  120.      --ff _a_r_g      Allows a user to specify an argument to be
  121.                  interpreted as a filesystem specification.  The
  122.                  class is set to FFIILLSSRRVV.  he instance is set to
  123.                  _a_r_g as modified: If _a_r_g contains no colons
  124.                  (`:'), it is assumed to be a host name, and it
  125.                  is converted into an official host name via
  126.  
  127.  
  128.  
  129. MIT Project Athena      October 26, 1989                        2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ZWRITE                    User Commands                    ZWRITE
  137.  
  138.  
  139.  
  140.                  _g_e_t_h_o_s_t_b_y_n_a_m_e(_3). If _a_r_g contains a colon, the
  141.                  portion preceding the colon is treated as a host
  142.                  name, and the colon and any trailing characters
  143.                  are appended to the offical host name returned
  144.                  by _g_e_t_h_o_s_t_b_y_n_a_m_e. If the name fails to resolve
  145.                  into an official host name, the instance is set
  146.                  to _a_r_g unmodified.
  147.                  This option may not be used in conjunction with
  148.                  the -c or -i option.
  149.  
  150.      --mm          _Z_w_r_i_t_e sends the remaining arguments on the com-
  151.                  mand line as the message.
  152.  
  153.      If the -_m option is not specified, the user is prompted for
  154.      the message to be sent.  The message may be terminated by
  155.      typing ^D or ``.'' on a line by itself.
  156.  
  157.      The default class for messages is ``MESSAGE'', the default
  158.      instance is ``PERSONAL'', andthe default opcode is ``'' (an
  159.      empty string).  These defaults can be overridden by setting
  160.      the Zephyr variables _z_w_r_i_t_e-_c_l_a_s_s, _z_w_r_i_t_e-_i_n_s_t, and _z_w_r_i_t_e-
  161.      _o_p_c_o_d_e, respectively.  Command-line options can override the
  162.      defaults.
  163.  
  164.      If the class is ``MESSAGE'' and the instance is either
  165.      ``PERSONAL'' or ``URGENT'', a recipient must be specified.
  166.      These comparisons are case-sensitive.
  167.  
  168.      Unless the --ss option is used, the contents of the Zephyr
  169.      variable _z_w_r_i_t_e-_s_i_g_n_a_t_u_r_e are used to augment the user's
  170.      username in the message.  If _z_w_r_i_t_e-_s_i_g_n_a_t_u_r_e is not set and
  171.      the --ss option is not specified, the user's full name (as
  172.      specified in the password file) is used instead.
  173.  
  174. BBUUGGSS
  175.      Tab expansion should really be done by the receiver of the
  176.      message.
  177.      The -u option is provided for compatibility with old ver-
  178.      sions of _z_w_r_i_t_e and is not necessarily useful for sending
  179.      messages to users who do not have old subscription files.
  180.  
  181. SSEEEE AALLSSOO
  182.      kerberosintro(1), zctl(1), zephyr(1), zwgc(1), zhm(8),
  183.      zephyrd(8), gethostbyname(3)
  184.      Project Athena Technical Plan Section E.4.1, `Zephyr Notifi-
  185.      cation Service'
  186.  
  187. FFIILLEESS
  188.      /etc/passwd
  189.      $HOME/.zephyr.vars
  190.  
  191.  
  192.  
  193.  
  194.  
  195. MIT Project Athena      October 26, 1989                        3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ZWRITE                    User Commands                    ZWRITE
  203.  
  204.  
  205.  
  206. AAUUTTHHOORR
  207.      Robert S. French (MIT-Project Athena)
  208.  
  209. RREESSTTRRIICCTTIIOONNSS
  210.      Copyright (c) 1987,1988 by the Massachusetts Institute of
  211.      Technology.  All Rights Reserved.
  212.      _z_e_p_h_y_r(_1) specifies the terms and conditions for redistribu-
  213.      tion.
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. MIT Project Athena      October 26, 1989                        4
  262.  
  263.  
  264.  
  265.